idapi32cfg
==========

Copyright (C) 2010 Adrian Oboroc <https://idapi32cfg.codeplex.com/>


WARNING
-------

idapi32cfg 1.0.0 is provided for historical reasons and to help people discover
new versions. Project was renamed to bdecli and is hosted on GitHub:
<https://github.com/oboroc/bdecli/>. As of February 2016, two serious bugs were
fixed. If you are using idapi32cfg 1.0.0, please consider replacing it with
bdecli v1.0.4 or later.


About idapi32cfg
----------------

idapi32cfg is a Borland Database command-line interface configuration tool. It
can be included in deployment scripts or MSI custom actions to add or
overwrite idapi32.cfg configuration settings in unattended mode.

One way to handle idapi32.cfg file updates is to keep a master copy, modify it
in bdeadmin tool from Borland when necessary and then push updated file to all
workstation. If this is how you handle it, you dont need idapi32cfg.

If, however, you want to have multiple configurations in the field and you
don't want to have an MSI overwrite idapi32.cfg file and delete all previous
custom settings, you should give idapi32cfg a try. It will allow you to import
or update just the settings for the app you deploy and keep all other settings
intact.

idapi32cfg executable from April 2010 was compiled using Visual C++ 2010 with
statically linked run-time and compressed with UPX.


Using idapi32cfg
----------------

Start with a generic blank idapi32.cfg file. You can create one by deleting
your current idapi32.cfg file, opening bdeadmin tool and saving default
settings in new idapi32.cfg.

Export default settings to a text file using the following command:

		idapi32cfg -e idapi32.cfg default.txt

Now open bdeadmin program again and make necessary configuration changes for
your application. Save to idapi32.cfg.

Export updated idapi32.cfg file to another text file:

		idapi32cfg -e idapi32.cfg updated.txt

Use your favorite text file comparison tool (fc, windiff, winmerge etc.) to
find all lines in updated.txt that are not part of default.txt and put the
difference in a new text file. Lets call it cfgdiff.txt.

Add this new text file and idapi32cfg executable to your MSI project or deployment
script. Use the following command to import application specific configuration
settings:

		idapi32cfg -i idapi32.cfg cfgdiff.txt
